跳到主要内容

支付授权

积分支付授权

DeBox提供了基于vDBX的支付授权接口,为vDBX提供更广阔的应用场景。

目前安卓1.8.18、ios1.5.2以上版本支持DeBox App内授权,
DeBox网页端只支持登录授权,暂不支持支付授权

Gethttps://app.debox.pro/oauth/authorize

⼀次性token请求接⼝,该接口用来生成积分支付的订单号和token,和下面的/payment/transfer接口联合使用完成积分支付功能。

Parameters

Query

redirect_uri : String 授权成功跳转链接,需要用encodeURIComponent编码

app_id : String 应用唯一标识,DeBox开发者社区申请

scope : String 授权范围(payment)

grant_type : String 授权类型(onetime_token)

amount : Number 金额,最多两位小数

payer_user_id : String 发送方user_id。pay_type为send时,该参数为授权用户的user_id;pay_type为receive时,该参数为第三方开发者的user_id

receiver_user_id : String 接收方user_id。pay_type为send时,该参数为第三方开发者的user_id;pay_type为receive时,该参数为授权用户的user_id

pay_type : String 代表授权用户的角色。该参数为send代表授权用户是支付方,该参数为receive时代表授权用户是收款方

pay_info : String 转账信息,用于提示支付的场景

Responses

200: OK
{ 
"code": "xxx", // 授权token,⽤于转账请求 有效期5分钟
"serial_id": "xxx", // 订单号
"source ": "debox" // 来源
}

Posthttps://open.debox.pro/openapi/payment/transfer

转账接口

Parameters

Query

app_id : 应用的app_id

app_secret : 应用的密钥 AppSecret,DeBox开发者社区申请

Body

access_token : 授权得到的code

serial_id : 授权得到的流水号(订单号)

Responses

200: OK
{ 
"code": "", // 错误码,1为成功
"msg": "",
"source ": "debox" // 来源
}
支付授权错误码

-2001 ⽤户登录有效性问题,可尝试重新登录
-2004 参数不合法
-2006 交易参数不合法
-2014 系统异常,请重试
-2015 access token 校验失败
-2016 重复发起转账请求
-2028 系统异常,请重试
-2030 系统异常,请重试
-7048 余额不⾜,转账失败
-7052 系统异常,请重试

如何实现⽤户还款⽆需平台处理

请求授权token时,⽤户发起提款后,跳转⽤户授权,此时将发送⽅设置为平台绑定的收 付款⽤户,接收⽅为提款⽤户,设置 pay_type 为 receive ,授权时会debox会校验收付款 双⽅。得到token和流⽔号后请求转账接⼝,则可执⾏转账。

三⽅平台需保管好⾃⼰的app_id和app_secret,泄漏会有资⾦损失⻛险。